Skip to content

docs(protocol): fork Issue → .opensiro case → separately consented original Issue - #37

Merged
xLagerFeuer merged 1 commit into
mainfrom
docs/fork-issue-local-handoff-20261117
Nov 17, 2026
Merged

xLagerFeuer merged 1 commit into
mainfrom
docs/fork-issue-local-handoff-20261117

Conversation

@xLagerFeuer

Copy link
Copy Markdown
Member

Why

Fix the confusion between fork GitHub Issue, issue-local evidence in a fork's .opensiro/, and fork-local review PR. The owner selected this workflow:

Fork Issue (if approved) → research/contract under .opensiro/issues/<case-id>/ → original Issue only on separate exact approval.

There is no cross-owner GitHub native Issue transfer in this route; it is a separately created original Issue or a reference to an existing original Issue. Do not duplicate an existing original native proposal, claim comments/reactions/number are transferred, or automatically close the fork Issue.

Changes

  • PROTOCOL.md: new explicit four-stage issue publication/evidence route; require separate current-conversation exact approval for a public fork Issue and for a new original Issue; preflight matching parent and live owner-control; original issue dedupe; readback/cross-links; no implicit product PR, code implementation, Index regrade or automatic closure.
  • docs/FORK_METADATA.md: .opensiro/issues/<case-id>/ on the fork's dedicated opensiro/meta worktree is authoritative for per-fork roadmap, source-native research, construction/acceptance contract and issue drafts. Distinguish this from actual .opensiro/contributions/ implementation records, meta controls and GitHub Issues.
  • docs/CAPABILITY_ROADMAP.md: route requested durable plans to verified fork issue-local storage and link accepted migrated Paperclip/Browser Harness records. Generic protocol/validator only in Upstream.
  • Remove previously duplicated docs/examples/{browser-harness-roadmap-20261117,paperclip-roadmap-20261117,paperclip-s4-constructor-acceptance-20261117}.md from current Upstream. Their content was already saved/read back on the correctly parented fork opensiro/meta branches, and historical central commits are retained.
  • Convert the central test suite to a synthetic, source-neutral plan-only receipt fixture and regression tests for storage/consent separation.
  • CHANGELOG.md unreleased note. No version/release change.

Existing fork-local artifact sources

Validation

  • python3 -m unittest discover -s tests -q: 118 PASS.
  • python3 -m compileall -q scripts: PASS.
  • git diff --check: PASS.
  • No public fork Issue, original issue/comment/PR or fork-local review PR created; Paperclip original/product branches unchanged.

…l issue

Pin two independent public issue publication gates, original issue dedupe,
non-transfer semantics, isolated meta-worktree storage and no implicit
implementation. Remove central per-fork roadmap copies already migrated
to matched fork metadata and preserve source-neutral validator tests.
@xLagerFeuer
xLagerFeuer merged commit c629f24 into main Nov 17, 2026
1 check passed
@xLagerFeuer
xLagerFeuer deleted the docs/fork-issue-local-handoff-20261117 branch November 17, 2026 20:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant